<!DOCTYPE html>



  


<html class="theme-next muse use-motion" lang="zh-Hans">
<head>
  <meta charset="UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"/>
<meta name="theme-color" content="#222">









<meta http-equiv="Cache-Control" content="no-transform" />
<meta http-equiv="Cache-Control" content="no-siteapp" />
















  
  
  <link href="/blog/lib/fancybox/source/jquery.fancybox.css?v=2.1.5" rel="stylesheet" type="text/css" />







<link href="/blog/lib/font-awesome/css/font-awesome.min.css?v=4.6.2" rel="stylesheet" type="text/css" />

<link href="/blog/css/main.css?v=5.1.4" rel="stylesheet" type="text/css" />


  <link rel="apple-touch-icon" sizes="180x180" href="/blog/images/apple-touch-icon-next.png?v=5.1.4">


  <link rel="icon" type="image/png" sizes="32x32" href="/blog/images/favicon-32x32-next.png?v=5.1.4">


  <link rel="icon" type="image/png" sizes="16x16" href="/blog/images/favicon-16x16-next.png?v=5.1.4">


  <link rel="mask-icon" href="/blog/images/logo.svg?v=5.1.4" color="#222">





  <meta name="keywords" content="Hexo, NexT" />










<meta name="description" content="大概一年前就开始关注KODI了，确实是个非常不错的开源项目，KODI提供很好的操作界面，但作为一个命令行控或者是没有显示屏的树莓派，我希望能够通过命令行对其进行控制，比如播放、暂停、静音等等. 于是去搜索了下，发现有个JSON-RPC，他是kODI官网推出的，方便其他开发者对接，到目前为止已经更新到v8，可以点击这里查看。这里将为大家详细介绍下它的用法。 初步印象在使用JSON-RPC，必须开启，">
<meta property="og:type" content="article">
<meta property="og:title" content="KODI JSON-RPC解读">
<meta property="og:url" content="http://smallmuou.gitee.io/blog/2017/03/20/2017-03-20-KODI JSON-RPC解读/index.html">
<meta property="og:site_name" content="smallmuou&#39;s blog">
<meta property="og:description" content="大概一年前就开始关注KODI了，确实是个非常不错的开源项目，KODI提供很好的操作界面，但作为一个命令行控或者是没有显示屏的树莓派，我希望能够通过命令行对其进行控制，比如播放、暂停、静音等等. 于是去搜索了下，发现有个JSON-RPC，他是kODI官网推出的，方便其他开发者对接，到目前为止已经更新到v8，可以点击这里查看。这里将为大家详细介绍下它的用法。 初步印象在使用JSON-RPC，必须开启，">
<meta property="og:locale" content="zh-Hans">
<meta property="og:updated_time" content="2020-04-16T01:15:21.804Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="KODI JSON-RPC解读">
<meta name="twitter:description" content="大概一年前就开始关注KODI了，确实是个非常不错的开源项目，KODI提供很好的操作界面，但作为一个命令行控或者是没有显示屏的树莓派，我希望能够通过命令行对其进行控制，比如播放、暂停、静音等等. 于是去搜索了下，发现有个JSON-RPC，他是kODI官网推出的，方便其他开发者对接，到目前为止已经更新到v8，可以点击这里查看。这里将为大家详细介绍下它的用法。 初步印象在使用JSON-RPC，必须开启，">



<script type="text/javascript" id="hexo.configurations">
  var NexT = window.NexT || {};
  var CONFIG = {
    root: '/blog/',
    scheme: 'Muse',
    version: '5.1.4',
    sidebar: {"position":"left","display":"post","offset":12,"b2t":false,"scrollpercent":false,"onmobile":false},
    fancybox: true,
    tabs: true,
    motion: {"enable":true,"async":false,"transition":{"post_block":"fadeIn","post_header":"slideDownIn","post_body":"slideDownIn","coll_header":"slideLeftIn","sidebar":"slideUpIn"}},
    duoshuo: {
      userId: '0',
      author: '博主'
    },
    algolia: {
      applicationID: '',
      apiKey: '',
      indexName: '',
      hits: {"per_page":10},
      labels: {"input_placeholder":"Search for Posts","hits_empty":"We didn't find any results for the search: ${query}","hits_stats":"${hits} results found in ${time} ms"}
    }
  };
</script>



  <link rel="canonical" href="http://smallmuou.gitee.io/blog/2017/03/20/2017-03-20-KODI JSON-RPC解读/"/>





  <title>KODI JSON-RPC解读 | smallmuou's blog</title>
  








</head>

<body itemscope itemtype="http://schema.org/WebPage" lang="zh-Hans">

  
  
    
  

  <div class="container sidebar-position-left page-post-detail">
    <div class="headband"></div>

    <header id="header" class="header" itemscope itemtype="http://schema.org/WPHeader">
      <div class="header-inner"><div class="site-brand-wrapper">
  <div class="site-meta ">
    

    <div class="custom-logo-site-title">
      <a href="/blog/"  class="brand" rel="start">
        <span class="logo-line-before"><i></i></span>
        <span class="site-title">smallmuou's blog</span>
        <span class="logo-line-after"><i></i></span>
      </a>
    </div>
      
        <p class="site-subtitle"><a href="https://github.com/smallmuou">https://github.com/smallmuou</a></p>
      
  </div>

  <div class="site-nav-toggle">
    <button>
      <span class="btn-bar"></span>
      <span class="btn-bar"></span>
      <span class="btn-bar"></span>
    </button>
  </div>
</div>

<nav class="site-nav">
  

  
    <ul id="menu" class="menu">
      
        
        <li class="menu-item menu-item-home">
          <a href="/blog/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-home"></i> <br />
            
            首页
          </a>
        </li>
      
        
        <li class="menu-item menu-item-archives">
          <a href="/blog/archives/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-archive"></i> <br />
            
            归档
          </a>
        </li>
      
        
        <li class="menu-item menu-item-categories">
          <a href="/blog/categories/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-th"></i> <br />
            
            分类
          </a>
        </li>
      
        
        <li class="menu-item menu-item-about">
          <a href="/blog/about/" rel="section">
            
              <i class="menu-item-icon fa fa-fw fa-user"></i> <br />
            
            关于
          </a>
        </li>
      

      
    </ul>
  

  
</nav>



 </div>
    </header>

    <main id="main" class="main">
      <div class="main-inner">
        <div class="content-wrap">
          <div id="content" class="content">
            

  <div id="posts" class="posts-expand">
    

  

  
  
  

  <article class="post post-type-normal" itemscope itemtype="http://schema.org/Article">
  
  
  
  <div class="post-block">
    <link itemprop="mainEntityOfPage" href="http://smallmuou.gitee.io/blog/blog/2017/03/20/2017-03-20-KODI JSON-RPC解读/">

    <span hidden itemprop="author" itemscope itemtype="http://schema.org/Person">
      <meta itemprop="name" content="smallmuou">
      <meta itemprop="description" content="">
      <meta itemprop="image" content="/blog/images/avatar.gif">
    </span>

    <span hidden itemprop="publisher" itemscope itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="smallmuou's blog">
    </span>

    
      <header class="post-header">

        
        
          <h1 class="post-title" itemprop="name headline">KODI JSON-RPC解读</h1>
        

        <div class="post-meta">
          <span class="post-time">
            
              <span class="post-meta-item-icon">
                <i class="fa fa-calendar-o"></i>
              </span>
              
                <span class="post-meta-item-text">发表于</span>
              
              <time title="创建于" itemprop="dateCreated datePublished" datetime="2017-03-20T00:00:00+08:00">
                2017-03-20
              </time>
            

            

            
          </span>

          
            <span class="post-category" >
            
              <span class="post-meta-divider">|</span>
            
              <span class="post-meta-item-icon">
                <i class="fa fa-folder-o"></i>
              </span>
              
                <span class="post-meta-item-text">分类于</span>
              
              
                <span itemprop="about" itemscope itemtype="http://schema.org/Thing">
                  <a href="/blog/categories/树莓派/" itemprop="url" rel="index">
                    <span itemprop="name">树莓派</span>
                  </a>
                </span>

                
                
              
            </span>
          

          

          
          

          

          

          

        </div>
      </header>
    

    
    
    
    <div class="post-body" itemprop="articleBody">

      
      

      
        <p>大概一年前就开始关注KODI了，确实是个非常不错的开源项目，KODI提供很好的操作界面，但作为一个命令行控或者是没有显示屏的树莓派，我希望能够通过命令行对其进行控制，比如播放、暂停、静音等等. 于是去搜索了下，发现有个JSON-RPC，他是kODI官网推出的，方便其他开发者对接，到目前为止已经更新到v8，可以点击<a href="http://kodi.wiki/view/JSON-RPC_API" target="_blank" rel="noopener">这里查看</a>。这里将为大家详细介绍下它的用法。</p>
<h3 id="初步印象"><a href="#初步印象" class="headerlink" title="初步印象"></a>初步印象</h3><p>在使用JSON-RPC，必须开启，可以进入设置 - 服务 - 控制，开启服务，可设置端口、用户名、密码，当然可以不设置用户名和密码</p>
<h3 id="入门"><a href="#入门" class="headerlink" title="入门"></a>入门</h3><p>JSON-RPC顾名思义就是采用JSON进行RPC通信，那么它的<a href="http://www.jsonrpc.org/specification" target="_blank" rel="noopener">基本格式</a>如下：</p>
<h5 id="请求-REQUEST"><a href="#请求-REQUEST" class="headerlink" title="请求(REQUEST)"></a>请求(REQUEST)</h5><ul>
<li>URI：<a href="http://host:port/jsonrpc" target="_blank" rel="noopener">http://host:port/jsonrpc</a></li>
<li>METHOD：POST</li>
<li>HEADER：ContentType:application/json</li>
<li>BODY: {“jsonrpc”:”2.0”, “method”:”xx”, “params”:{}, “id”:xx},jsonrpc必须是2.0，这个与实际版本无关 method为具体方法，会在后面介绍，params为method对应的参数，若无，则可以不传 id是由客户端定义，用于标识客户端，服务器会返回相同的id（见响应）</li>
</ul>
<p>如：</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">curl -X POST -H &quot;ContentType:application/json&quot; -d &apos;&#123;&quot;jsonrpc&quot;: &quot;2.0&quot;, &quot;method&quot;: &quot;JSONRPC.Version&quot;, &quot;id&quot;:&quot;22&quot;&#125;&apos; http://localhost:8080/jsonrpc</span><br></pre></td></tr></table></figure>
<h5 id="响应-RESPONSE"><a href="#响应-RESPONSE" class="headerlink" title="响应(RESPONSE)"></a>响应(RESPONSE)</h5><ul>
<li>BODY:  {“jsonrpc”:”2.0”, “result”:”xxx”,”error”:{“code”:xx,”message”:”xxx”,”data”:”xxx”},”id”:xx }  result为返回结果，若错误，则空，error错误，id为请求传递的，若错误，为空</li>
</ul>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">&#123;&quot;id&quot;:&quot;22&quot;,&quot;jsonrpc&quot;:&quot;2.0&quot;,&quot;result&quot;:&#123;&quot;version&quot;:&#123;&quot;major&quot;:8,&quot;minor&quot;:0,&quot;patch&quot;:0&#125;&#125;&#125;</span><br></pre></td></tr></table></figure>
<h3 id="进阶"><a href="#进阶" class="headerlink" title="进阶"></a>进阶</h3><p>以上内容就好比是内功，有了好的内功，其他的都好学，在之前的REQUEST我们了解到了method和params，那么我们来看看都有哪些外功. 外功分为v2、v4、v6、v8几个版本，目前最新的是v8，可以通过上面给出的例子，获取到当前版本. 竟然我用到的是v8，我们就来看下<a href="http://kodi.wiki/view/JSON-RPC_API/v8" target="_blank" rel="noopener">v8</a>的定义。 v8是随着kodi v17一同发布的，它支持WebSocket。正所谓举其一可知大概，我在这里就不对所有的method进行介绍，我会抽出几个，告知大家如何看懂文档。</p>
<ul>
<li>Player.GetActivePlayers - 获取当前激活的播放器</li>
</ul>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br></pre></td><td class="code"><pre><span class="line">5.9.1 Player.GetActivePlayers</span><br><span class="line">Returns all active players</span><br><span class="line">Permissions:</span><br><span class="line">    ReadData</span><br><span class="line">Returns:</span><br><span class="line">    Type: array</span><br></pre></td></tr></table></figure>
<p>Permissions 权限，可通过JSONRPC.Permission获取权限开关状态<br>Returns：返回</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">curl -X POST --header &quot;content-type:application/json&quot; --data &apos;&#123;&quot;jsonrpc&quot;: &quot;2.0&quot;, &quot;method&quot;: &quot;Player.GetActivePlayers&quot;, &quot;id&quot;:&quot;22&quot;&#125;&apos; http://localhost:8080/jsonrpc</span><br><span class="line"></span><br><span class="line">&#123;&quot;id&quot;:&quot;22&quot;,&quot;jsonrpc&quot;:&quot;2.0&quot;,&quot;result&quot;:[&#123;&quot;playerid&quot;:0,&quot;type&quot;:&quot;audio&quot;&#125;]&#125;</span><br></pre></td></tr></table></figure>
<ul>
<li>Application.SetVolume - 设置音量</li>
</ul>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br><span class="line">4</span><br><span class="line">5</span><br><span class="line">6</span><br><span class="line">7</span><br><span class="line">8</span><br></pre></td><td class="code"><pre><span class="line">5.2.4 Application.SetVolume</span><br><span class="line">Set the current volume</span><br><span class="line">Permissions:</span><br><span class="line">    ControlPlayback</span><br><span class="line">Parameters:</span><br><span class="line">    mixed volume</span><br><span class="line">Returns:</span><br><span class="line">    Type: integer</span><br></pre></td></tr></table></figure>
<p>例子：</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line"> curl -X POST --header &quot;content-type:application/json&quot; --data &apos;&#123;&quot;jsonrpc&quot;: &quot;2.0&quot;, &quot;method&quot;: &quot;Application.SetVolume&quot;, &quot;params&quot;:&#123;&quot;volume&quot;:8&#125;, &quot;id&quot;:&quot;22&quot;&#125;&apos; http://localhost:8080/jsonrpc</span><br><span class="line"> </span><br><span class="line">&#123;&quot;id&quot;:&quot;22&quot;,&quot;jsonrpc&quot;:&quot;2.0&quot;,&quot;result&quot;:8&#125;</span><br></pre></td></tr></table></figure>
<h3 id="扩展"><a href="#扩展" class="headerlink" title="扩展"></a>扩展</h3><p>当然KODI还提供了kodi-send命令，来简化请求，格式如下：</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">kodi-send -a &quot;XXX&quot;</span><br></pre></td></tr></table></figure>
<p>xxx见<a href="http://kodi.wiki/view/List_of_built-in_functions" target="_blank" rel="noopener">http://kodi.wiki/view/List_of_built-in_functions</a></p>
<p>如</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">osmc@osmc:~$ kodi-send -a &quot;SetVolume(10)&quot;</span><br><span class="line">Sending action: SetVolume(10)</span><br></pre></td></tr></table></figure>

      
    </div>
    
    
    

    

    

    

    <footer class="post-footer">
      

      
      
      

      
        <div class="post-nav">
          <div class="post-nav-next post-nav-item">
            
              <a href="/blog/2017/03/15/2017-03-15-解决Github Page无法更新/" rel="next" title="解决Github Page无法更新">
                <i class="fa fa-chevron-left"></i> 解决Github Page无法更新
              </a>
            
          </div>

          <span class="post-nav-divider"></span>

          <div class="post-nav-prev post-nav-item">
            
              <a href="/blog/2017/03/21/2017-03-21-命令行下高性能的JSON工具/" rel="prev" title="命令行下高性能的JSON工具">
                命令行下高性能的JSON工具 <i class="fa fa-chevron-right"></i>
              </a>
            
          </div>
        </div>
      

      
      
    </footer>
  </div>
  
  
  
  </article>



    <div class="post-spread">
      
    </div>
  </div>


          </div>
          


          

        </div>
        
          
  
  <div class="sidebar-toggle">
    <div class="sidebar-toggle-line-wrap">
      <span class="sidebar-toggle-line sidebar-toggle-line-first"></span>
      <span class="sidebar-toggle-line sidebar-toggle-line-middle"></span>
      <span class="sidebar-toggle-line sidebar-toggle-line-last"></span>
    </div>
  </div>

  <aside id="sidebar" class="sidebar">
    
    <div class="sidebar-inner">

      

      
        <ul class="sidebar-nav motion-element">
          <li class="sidebar-nav-toc sidebar-nav-active" data-target="post-toc-wrap">
            文章目录
          </li>
          <li class="sidebar-nav-overview" data-target="site-overview-wrap">
            站点概览
          </li>
        </ul>
      

      <section class="site-overview-wrap sidebar-panel">
        <div class="site-overview">
          <div class="site-author motion-element" itemprop="author" itemscope itemtype="http://schema.org/Person">
            
              <p class="site-author-name" itemprop="name">smallmuou</p>
              <p class="site-description motion-element" itemprop="description"></p>
          </div>

          <nav class="site-state motion-element">

            
              <div class="site-state-item site-state-posts">
              
                <a href="/blog/archives/">
              
                  <span class="site-state-item-count">197</span>
                  <span class="site-state-item-name">日志</span>
                </a>
              </div>
            

            
              
              
              <div class="site-state-item site-state-categories">
                <a href="/blog/categories/index.html">
                  <span class="site-state-item-count">12</span>
                  <span class="site-state-item-name">分类</span>
                </a>
              </div>
            

            

          </nav>

          

          
            <div class="links-of-author motion-element">
                
                  <span class="links-of-author-item">
                    <a href="https://github.com/smallmuou" target="_blank" title="GitHub">
                      
                        <i class="fa fa-fw fa-globe"></i>GitHub</a>
                  </span>
                
            </div>
          

          
          

          
          

          

        </div>
      </section>

      
      <!--noindex-->
        <section class="post-toc-wrap motion-element sidebar-panel sidebar-panel-active">
          <div class="post-toc">

            
              
            

            
              <div class="post-toc-content"><ol class="nav"><li class="nav-item nav-level-3"><a class="nav-link" href="#初步印象"><span class="nav-number">1.</span> <span class="nav-text">初步印象</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#入门"><span class="nav-number">2.</span> <span class="nav-text">入门</span></a><ol class="nav-child"><li class="nav-item nav-level-5"><a class="nav-link" href="#请求-REQUEST"><span class="nav-number">2.0.1.</span> <span class="nav-text">请求(REQUEST)</span></a></li><li class="nav-item nav-level-5"><a class="nav-link" href="#响应-RESPONSE"><span class="nav-number">2.0.2.</span> <span class="nav-text">响应(RESPONSE)</span></a></li></ol></li></ol></li><li class="nav-item nav-level-3"><a class="nav-link" href="#进阶"><span class="nav-number">3.</span> <span class="nav-text">进阶</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#扩展"><span class="nav-number">4.</span> <span class="nav-text">扩展</span></a></li></ol></div>
            

          </div>
        </section>
      <!--/noindex-->
      

      

    </div>
  </aside>


        
      </div>
    </main>

    <footer id="footer" class="footer">
      <div class="footer-inner">
        <div class="copyright">&copy; <span itemprop="copyrightYear">2020</span>
  <span class="with-love">
    <i class="fa fa-user"></i>
  </span>
  <span class="author" itemprop="copyrightHolder">smallmuou</span>

  
</div>

    <script async src="https://busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>

    <span id="busuanzi_container_site_pv">总访问量<span id="busuanzi_value_site_pv"></span>次</span>
    <span class="post-meta-divider">|</span>



  <div class="powered-by">由 <a class="theme-link" target="_blank" href="https://hexo.io">Hexo</a> 强力驱动</div>



  <span class="post-meta-divider">|</span>



  <div class="theme-info">主题 &mdash; <a class="theme-link" target="_blank" href="https://github.com/iissnan/hexo-theme-next">NexT.Muse</a> v5.1.4</div>




        







        
      </div>
    </footer>

    
      <div class="back-to-top">
        <i class="fa fa-arrow-up"></i>
        
      </div>
    

    

  </div>

  

<script type="text/javascript">
  if (Object.prototype.toString.call(window.Promise) !== '[object Function]') {
    window.Promise = null;
  }
</script>









  












  
  
    <script type="text/javascript" src="/blog/lib/jquery/index.js?v=2.1.3"></script>
  

  
  
    <script type="text/javascript" src="/blog/lib/fastclick/lib/fastclick.min.js?v=1.0.6"></script>
  

  
  
    <script type="text/javascript" src="/blog/lib/jquery_lazyload/jquery.lazyload.js?v=1.9.7"></script>
  

  
  
    <script type="text/javascript" src="/blog/lib/velocity/velocity.min.js?v=1.2.1"></script>
  

  
  
    <script type="text/javascript" src="/blog/lib/velocity/velocity.ui.min.js?v=1.2.1"></script>
  

  
  
    <script type="text/javascript" src="/blog/lib/fancybox/source/jquery.fancybox.pack.js?v=2.1.5"></script>
  


  


  <script type="text/javascript" src="/blog/js/src/utils.js?v=5.1.4"></script>

  <script type="text/javascript" src="/blog/js/src/motion.js?v=5.1.4"></script>



  
  

  
  <script type="text/javascript" src="/blog/js/src/scrollspy.js?v=5.1.4"></script>
<script type="text/javascript" src="/blog/js/src/post-details.js?v=5.1.4"></script>



  


  <script type="text/javascript" src="/blog/js/src/bootstrap.js?v=5.1.4"></script>



  


  




	





  





  












  





  

  

  

  
  

  

  

  

</body>
</html>
